(PIN) Awards Management System installation guide
File Information
- File Name
- (PIN) Awards Management System
- Version
- v1.0.0 RC 8
- Author Name
- peaderfi
- Resource Type
- Application
- Compatability
- IP.Board: 3.0.x
PHP: 5.x
MySQL: 4.x
Description
(PIN) Awards Management System
The (PIN) Awards Management System is, as the name suggests, an awards management system. It allows you, as the admin, to create and define awards categories and place awards within those categories. It gives you the power to decide who is able to view, give and take awards on a per category basis. You are also able to designate any number of groups as “Global Awards Mods”, these Global Awards Mods will be able to see, give and take awards from all of your categories. On the admin side you are able to restrict admins from accessing each of the main functions of the awards mod.
Two hooks ship with this mod, one to place the mod buttons in the profile for those who have the permissions to give and remove awards and the other is the awards cabinet that is shown in the topic view which has two options when enabled in the Awards Settings.
Step 1: Files to Upload
| File/Contents of Folder in Download | File/Folder on Server | |
| /upload/admin/applications/ | → | /admin/applications/ |
| /upload/admin/applications_addon/ | → | /admin/applications_addon/ |
| /upload/admin/skin_cp/ | → | /admin/skin_cp/ |
| /upload/public/js/ | → | /public/js/ |
| /upload/public/style_images/master/ | → | /public/style_images/master/ |
| /upload/public/style_images/master/ | → | /public/style_images/other-skin-image-folders/ |
Step 2: Install the Application
Visit your IP.Board Admin CP and click the link on the navigation bar to the left entitled, 'Manage Applications & Modules'. Scroll down the page until you see an entry for "(PIN) Awards Management System", click 'Install' and follow the on-screen instructions.
Step 3: Configuration
Once installed, you will now see a tab entitled "(PIN) Awards Management System", in the dropdown 'My Apps', this is the central home-screen for the application.
From this homepage you can access the three pages which are used to configure and manage the application:
Awards System Settings
Awards User Management
Awards System Management
This is the nerve centre of the application. From here you can Add/Edit/Remove Awards Categories, Add/Edit/Remove Awards, Reorder the categories via a simple "Drag & Drop" interface, as well as recaching the entire application with the click of a button. On your first run you will need to create an Awards Category before you can create and use your awards. All awards must be in an Awards Category for the system to function properly.
Awards System Settings
From this page you can alter all of the settings that the system has. Every configurable option in the (PIN) Awards Management System has been provided here for easy access and configuration.
Awards User Management
From this page you can give awards to users and "De-Award" or take away awards from users. There is a public interface for doing both of these actions directly from an individual users public profile page, but if you are going to be awarding lots and lots of users this interface was provided to allow for quick granting of awards to multiple users without needing to know their individual profile page links.
Advanced Use
When you create an Awards Category you are given the option of setting up which permission masks can view and use the various public functions of the (PIN) Awards Management System. When editing the Awards Category you have the ability to alter these permissions as well.
This is all well and good, however lets say there is an individual group/permission mask that you wish to give/restrict access to a number of Awards Categories. In this case editing each Awards Category would be quite a bit of hassle. For this reason, using the built in "Manage User Permissions" page in the "Members" tab of your AdminCP you can alter an individual permission masks access to multiple Awards Categories in one action.
ACP Restrictions
This application also supports ACP Restrictions. If an Admin User Group/Admin User has ACP Restrictions setup then the Admins affected by those restrictions will be unable to manage the Awards System until they have been granted the proper permissions using the "Manage ACP Restrictions" page. Any admin for whom no restrictions are set will be able to manage and use all Admin Functions for the app. Should you wish to setup restrictions for an Admin User/User Group on the (PIN) Awards Management App it can be managed from this page.